pageIncrement

Type

property

Summary

Specifies how far a scrollbar moves when the user clicks somewhere in its gray region.

Syntax

set the pageIncrement of <scrollbar> to <pageAmount>

Description

Use the pageIncrement property to change the amount that is scrolled when the gray region is clicked.

When the user clicks in the gray region above or below the scrolling thumb (to the left or right, for a horizontal scrollbar), the scrollbar moves one page up or down (or to the left or right). Use the pageIncrement property to specify how far the scrolling thumb moves. The amount the scrollbar moves will equal the pageIncrement minus the lineIncrement. Setting the pageIncrement to be less than the lineIncrement causes the scrollbar to run backwards.

The startValue and endValue properties set the scale used for the pageIncrement/lineIncrement combination, so for example, if the pageIncrement minus the lineIncrement is set to one-tenth of the difference between the startValue and endValue, clicking the gray region moves the scrollbar one-tenth of its length.

Examples

set the pageIncrement of scrollbar "Content" to 200

Related

keyword: scrollbar

message: scrollbarPageDec, scrollbarPageInc

property: repeatRate, lineIncrement

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server